home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / os_2 / clisp.zip / README < prev    next >
Text File  |  1994-02-05  |  6KB  |  195 lines
  1. This is CLISP, a Common Lisp implementation.
  2.  
  3.  
  4. What is LISP?
  5. -------------
  6.  
  7. LISP is a programming language. It was invented by J. McCarthy in 1959.
  8. There have been many dialects of it, but nowadays LISP has been standardized
  9. and wide-spread due to the industrial standard COMMON LISP. There are
  10. applications in the domains of symbolic knowledge processing (AI), numerical
  11. mathematics (MACLISP yielded numerical code as good as FORTRAN), and
  12. widely used programs like editors (EMACS) and CAD (AUTOCAD).
  13. There is an introduction to the language:
  14.  
  15.   Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  16.   107 pages.
  17.  
  18. After a while wou will need the standard text containing the language
  19. definition:
  20.  
  21.   Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  22.   1. edition 1984, 465 pages.
  23.   2. edition 1990, 1032 pages.
  24.  
  25. LISP is run in an interactive environment. You input forms, and they will be
  26. evaluated at once. Thus you can inspect variables, call functions with given
  27. arguments or define your own functions.
  28.  
  29.  
  30. Contents:
  31. ---------
  32.  
  33. It consists of the following files:
  34.  
  35.       lisp.exe         main program
  36.       lispinit.mem     memory image needed for startup
  37.       clisp.1          manual page in Unix man format
  38.       clisp.man        manual page
  39.       clisp.dvi        manual page in dvi format
  40.       impnotes.txt     implementation notes
  41.       emx-user.doc     emx applications user's guide
  42.       emx-faq.doc      frequently asked questions about emx applications
  43.       emx.dll          OS/2 dynamic link library containing emx
  44.       emxlibc.dll      OS/2 dynamic link library containing the emx libc
  45.       README           this text
  46.       SUMMARY          short description of CLISP
  47.       ANNOUNCE         announcement
  48.       COPYRIGHT        copyright notice
  49.       GNU-GPL          free software license
  50.       config.lsp       site-dependent configuration
  51.  
  52. and - to your convenience, if you like reading source -
  53.  
  54.       *.lsp            the source of lispinit.mem
  55.       *.fas            the same files, already compiled
  56.  
  57.  
  58. Hardware requirements:
  59. ----------------------
  60.  
  61. This OS/2 version of CLISP requires an 80386 (SX or DX) or an 80486 CPU,
  62. running OS/2 2.0.
  63.  
  64.  
  65. Installation:
  66. -------------
  67.  
  68. First of all, install emx.dll and emxlibc.dll in a separate directory,
  69. say c:\emx\dll. Add c:\emx\dll (insert the correct drive letter)
  70. to the LIBPATH statement in your config.sys file. Reboot your computer
  71. to enable the new LIBPATH statement and the new environment variables.
  72.  
  73. Edit the contents of config.lsp appropriately for your site,
  74. especially the definitions of short-site-name and long-site-name.
  75. You may also want to edit the time zone definition in defs1.lsp.
  76. Then start
  77.  
  78.          lisp.exe -M lispinit.mem
  79.  
  80. When the LISP prompt
  81.  
  82.       > _
  83.  
  84. appears, type
  85.  
  86.         (compile-file "config")
  87.         (load "config")
  88.  
  89. and - in case you modified defs1.lsp -
  90.  
  91.         (compile-file "defs1")
  92.         (load "defs1")
  93.  
  94. and then
  95.  
  96.         (saveinitmem)
  97.  
  98. to overwrite the file lispinit.mem with your configuration. Then
  99.  
  100.         (exit)
  101.  
  102. Then create a directory, and put the executable and the memory image there.
  103. Assuming D:\LIB\LISP :
  104.  
  105.    mkdir d:\lib\lisp
  106.    copy lisp.exe d:\lib\lisp
  107.    copy lispinit.mem d:\lib\lisp
  108.  
  109. And create a batch file that starts lisp:
  110.  
  111.    copy con c:\cmd\clisp.cmd
  112.    d:\lib\lisp\lisp.exe -M d:\lib\lisp\lispinit.mem %1 %2 %3 %4 %5 %6 %7 %8 %9
  113.    [Ctrl-Z]
  114.  
  115.  
  116. The editor:
  117. -----------
  118.  
  119. Normally CLISP's ED function calls the editor you specified in config.lsp.
  120. However, after you did
  121.  
  122.     (load "editor")
  123.  
  124. it invokes a builtin screen editor. It is a bit Emacs-like: you can evaluate
  125. lisp expressions from within the editor, and the result is pasted into the
  126. editor buffer. Type Alt-H to see the full set of commands.
  127.  
  128.  
  129. When you encounter problems:
  130. ----------------------------
  131.  
  132. If clisp doesn't start up at all, check EMX-USER.DOC. lisp.exe is an EMX
  133. application, so everything mentioned there applies to lisp.exe.
  134.  
  135. After errors, you are in the debugger:
  136.  
  137.      1. Break> _
  138.  
  139. You can evaluate forms, as usual. Furthermore:
  140.  
  141.      Help
  142.                calles help
  143.      Abort     or
  144.      Unwind
  145.                climbs up to next higher input loop
  146.      (show-stack)
  147.                shows the contents of the stack, helpful for debugging
  148.  
  149. And you can look at the values of the variables of the functions where the
  150. error occurred.
  151.  
  152. On bigger problems, e.g. register dumps, please send a description of the error
  153. and how to produce it reliably to the authors.
  154.  
  155.  
  156. Mailing List:
  157. -------------
  158.  
  159. There is a mailing list for users of CLISP. It is the proper forum for
  160. questions about CLISP, installation problems, bug reports, application
  161. packages etc.
  162.  
  163. For information about the list and how to subscribe it, send mail to
  164. listserv@ma2s2.mathematik.uni-karlsruhe.de, with the two lines
  165.           help
  166.           information clisp-list
  167. in the message body.
  168.  
  169.  
  170. Acknowledgement:
  171. ----------------
  172.  
  173. If you find CLISP fast and bug-free and you like using it, a gift of $25
  174. (or any amount you like) will be appreciated. Most DOS software costs
  175. something, so you will probably already be used to paying.
  176.  
  177. If not, feel free to send us suggestions for improvement. Or grab the
  178. source of CLISP, improve it yourself and send us your patches.
  179.  
  180. We are indebted to
  181.   * Guy L. Steele and many others for the Common Lisp specification.
  182.   * Richard Stallman's GNU project for GCC and the readline library.
  183.   * Eberhard Mattes for EMX.
  184.  
  185.  
  186. Authors:
  187. --------
  188.  
  189.         Bruno Haible                    Michael Stoll
  190.         Augartenstraße 40               Gallierweg 39
  191.     D - 76137 Karlsruhe             D - 53117 Bonn
  192.         Germany                         Germany
  193.  
  194. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  195.